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PURPOSE 


message 


A string object containing the actual message. 


value 


A value that can be associated with the above message. 


me 


The name of the sending module, for example, CARD_READER. 


id 


Unique ATM identification number given to every module in the team. 


port 


Port number of the server, when a return message can be sent. 


scan 


Identifies the message type. 
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JAVA CLASS 
FILES 


SUMMARY 


Account 


All access to the TopEnd server was achieved through the use of this 
class. It defined a simple bank account, with a balance and the 
amount of cash involved in the last transaction. The UTTA modules 
could access bank details through this class without concern about 
contacting TopEnd. 


Fault 


Fault defined a whole set of constant variables which were used by 
the three modules that simulated hardware errors - namely, the card 
reader, receipt printer, and cash dispenser. Its use was primarily to 
make the code easier to read. 


StringNode 


Because Java did not allow for the use of templates, for each kind of 
linked-list created the nodes for different data types had to be 
redefined. StringNode were used to create linked-lists where each 
node contained a simple String instance. 


Timer 


Timer was used throughout the code for the purpose of delaying a 
module's application flow. Delays were used where the software was 
simulating what the hardware does - for example, one was used 
within the cash dispenser to halt execution while it 'pretended' to 
transport the cash from the cassette to the staging area. 


ATM Interface 


This class provided standard interface methods for the card reader 
(Ulysses version) to talk to hardware. The CardReader class only 
knew about ATM Interface, however, it was actually Ulysseslnterface 
that is instantiated to do the work. 


CardReader 


The Java frame that contained application-control flow code for 
running a card reader module. There were two versions of this - the 
first which was only a software simulation, whereas the 'Hardware' 
version sent and received commands to control a real card reader. 


ErrorDialog 


The frame containing all the simulation error choices associated with 
the normal card reader. Note, that the ErrorDialog class was not 
found in the hardware version of the card reader as it was not used. 
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JAVA CLASS 
FILES 


SUMMARY 


StringClient 


An extension of the Thread class that allowed for the sending of 
simple String based messages across a network using sockets. 
This class was used to send card reader commands to the 
Windows-Ulysses program. 


StringServer 


An extension of the Thread class that continuously listened on a 
socket for incoming String based messages. 


Ulysseslnterface 


Deals with the command messages from the CardReader and also 
the response messages that were received from Windows (via 
StringServer). The class simply passed on the command messages, 
however, the incoming ones were deciphered and the correct 
response was passed back to the CardReader. 


CashDispenser 


The Java frame that contained application-control flow code for 
running a cash dispenser module 


ErrorDialog 


The frame containing all the simulation error choices associated with 
the above cash dispenser class. 


Message 


Message was a serialised object class, designed for sending across a 
network from module to module, being reconstructed at the receiving 
end. As well as the actual message, the Message class contained 
additional fields for information relating to the sending module. 


MessageApp 


This is the class that the four modules actually imported to handle 
their messages for them. It controlled both the ReceiveMessage 
thread and the registry of active modules. It contained interface 
methods that allowed a module to send and receive the messages. 


neceiveiviebbayc 


An extension of the Thread class that continuously listened on a 
socket for incoming messages from other modules. Once received, 
the class would pass the message back up to MessageApp for 
collection by a module. 


Registry 


Registry contains all the methods that dealt with accessing and 
maintaininn a Hot nf artivp mnrinlpc; in the ATM The same instance 

flldllltd.ll III IU Cl llol Ul a\iU VC 1 1 luuuico in ino ni i 1 wwi nv iu'«' 

of a Registy class within a Java virtual machine (such as the card 
reader) would be used and accessed by MessageApp, 
ReceiveMessage, and TransmitMessage. 


RegNode 


Defined the data that was stored at each location in a module's 
registry. It is used within a linked-list. 


TransmitMessage 


An extension of the Thread class that allowed for the sending of 
messages (based on the Message object) across a network. 
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JAVA CLASS 
FILES 


SUMMARY 


ReceiptPrinter 


The Java frame that contained application-control flow code for 
running a receipt printer module 


ErrorDialog 


The frame containing all the simulation error choices associated with 
the above receipt printer class. 


Application 


This is the main application-control flow for the user interface. It is 
the most complex of the four control flows as the display is the main 
form of interaction with the user. As well as the control flow, the 
class also contained code required to draw the various screens 
within its frame. 


ApplicationThread 


The thread created within this class was used to control two things - 
the display of screens on the main user interface, and to monitor 
the limits set for the various time-outs. If one occured, then this 
class informed the main Application of the event. 


DisplayField 


DisplayField objects were used within the Userlnterface class to 
provide text output to the screen. Using a larger font than normal, 
this class let the programmer position text accurately that will 
respond automatically to changes in the screen size and position. 


EchoField 


EchoField was used in several places within the main interface 
display. Firstly, during the PIN entry (or PIN entry retry) screen, an 
EchoField object was used to display '*' characters as each number 
was entered. It was also used to show user input in the cash entry 
screens, except this time no attempt to hide the characters was 
made. 


Userlnterface 


The main frame for the user interface. This only created an area for 
the display to happen. All the control flow and display code could be 
found within the Application class. 


WindowButton 


WindowButton was a special implementation of a button, that 
allowed for large on-screen buttons (that could contain images), 
that can expand or contract in size according to the size of the user 
interface. These 'buttons' could either contain just text, a picture, 
or a picture without the ability to press the button. 
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C++ FILE NAME 


SUMMARY 


StdAfx.h 


This is part of the standard included files for any Visual C++ MFC 
application. 


StdAfx.cpp 


A Visual C++ MFC specific file included in the prototype code for 
other user-created code to function. 


Resource.h 


A Visual C++ specific file that contains the code for Windows, 
controls, icons, etc., used within the prototype. 


UlyssesApp.h 


Defines variables and functions used by the UlyssesApp class that 
was actually responsible for creating and running the main 
application. 


UlyssesApp.cpp 


Contains the function definitions for starting up the application and 
creating the dialog instance. 


Message.h 


Various user defined message maps were used within the main 
dialog class to receive messages from the Java virtual machine. 
These messages are defined in this file, where they can then be 
used by any class or function that includes it. 


Server.h 


To properly run the server listening for Java messages in its own 
thread, the code for it was declared in a separate file from the main 
dialog. Server.h contained two functions - one that actually listens 
for the text messages on the network, and another to post those 
messages back to the dialog window. 


UlyssesDlg.h 


Defines the variables and functions used by the main dialog class. 


UlyssesDig.cpp 


This is the main application class file for the UlyssesApp prototype. 
This class was responsible for creating and setting up the Java 
server, registering itself with hardware (via the Ulysses API), and 
also passing messages between Java and the hardware. 


SettingsDIg.h 


Defines the variables and functions used by the settings dialog box 
that a user could pop up. 


SettingsDIg.cpp 


This contains the code for the settings box that allowed a user to 
decide if and where messages to Java are to be sent. 
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Response to... 


T-Code 


Meaning 




0 


Ok, reader enabled, no card present. UNSOLIC_RESPONSE to follow. 




1 


Ok, card staged in reader, reader disabled. No UNSOLIC_RESPONSE to follow. 




2 


Track not supported, read disabled. All commands available. 


ACCEPT 


3 


Device inoperative - do not issue any commands until severity is checked. 




4 


Card jam - eject or capture card. 




5 


Invalid or jammed card in reader, card ejected and UNSOLIC_RESPONSE message to follow. 




0 


Successful read. 




1 


Read error, all commands available. 




2 


Track not supported, all commands available. 


READ 


3 


Device inoperative - do not issue any commands until severity is checked. 






4 


Card jam - eject or capture card, or card removed, or too many read errors. 




5 


Blank track, all commands available. 




6 


No card present, all commands available. 




0 


Card written Ok. 




1 


Write error, all commands available. 




2 


Track 3 write not supported, all other commands available. 


WRITE 


3 


Device inoperative - do not issue any more commands until severity is checked. 




4 


Card jam - eject or capture card, OR too many write errors. 




5 


Write error, invalid data (length or format). 




6 


No card present, all commands available. 




0 


Card ejected, can be removed - all commands available. 


EJECT 


1 


No card present, all commands available. 




2 


Card captured, reader clear - all commands available. 




3 


Device inoperative - do not issue any commands until severity is checked. 




0 


Card captured Ok. 


PAPTI IPP 


1 


Transport clear, no card to capture. 


2 


Transport clear, card removed by customer 




3 


Device inoperative - do not issue any commands until severity is checked. 




0 


Card removed Ok. 




1 


Card detected entering reader. 






2 


Card inserted and staged Ok. 


UNSOLICITED 


3 


Device inoperative - do not issue any commands until severity is checked. 




4 


Card jam - eject or capture card. 






5 


Invalid card inserted in reader. Card ejected, UNSOLIC to follow. 




6 


Shutter jammed closed on attempted card entry. 



